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Overview for the Commodore 64 and 128 Computers 


CONTEMPORARY 
PROGRAMMING 
AND SOFTWARE 
DESIGN SERIES 


Welcome to your first module, Getting Started in 
Programming and Software Design, in the McGraw- 
Hill Contemporary Software Design Series. 

The disk supplied with this module is intended for 
the Commodore 64 computer and for the Com- 
modore 128 operating in C64 mode. Unless other- 
wise specified, all programs stored on this disk are 
written in BASIC, and can be loaded with the stand- 
ard LOAD “PROGRAM NAME?” ,8 instruction, 
followed by RUN. You should always place your 
program disk in drive #8, since some programs 
look for other programs on the disk, and will 
always look for them on device #8. 


So that all of the programs on your program disk 
can be run on the greatest possible number of com- 
puters, they are all recorded in the C64 format. 
Therefore, if you are using a C64, you can simply 
start up your computer as usual, insert your disk 
into Drive #8, and proceed. 

However, if you are using a C128, you will need to 
switch to C64 mode before you can run these pro- 
grams. You can do this by typing in the 
command: 


GO64<return> 


and then typing Y to confirm the command. From 
this point, you can run the demonstration programs 
just as if you were using a C64. 

C128 owners can still use the full power of their 
computers with this Series. The methods, proce- 
dures, and techniques that will be covered in the 
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Series are equally applicable to any computer, and 
indeed can be applied to any desired computer 
language as well. 

All disks are organized into tracks and sectors. In 
the Commodore 64 computer, data is written to the 
disk in 35 concentric tracks, or circles. Each track is 
further divided into a number of sectors to help the 
computer locate and use data as rapidly as possible. 
The diagram on page 1 shows how this works. 

To reflect this kind of disk organization, we have 
organized this module into Tracks and Sectors 
rather than into Topics or Chapters. 

As with all 5-1/4” disks, your program disk is 
packaged in a square paper container, and is pro- 
vided with a protective paper sleeve. Always handle 
your disk carefully. Never touch the exposed sur- 
faces of the disk, and never spill or drop anything on 
the disk. Remember: even a single particle of smoke 
can ruin the disk, the drive, or both! Keep the disk 
away from magnetic fields, unless you intend to 
deliberately erase the disk. Follow the handling 
instructions depicted on the back side of the paper 
sleeve. By doing this, you can prolong the life of your 
disk and disk drive substantially. 

The Commodore 64 uses only one side of the 
disk. The 128 can use both sides, by treating each 
side as a separate disk. However, to maintain full 
C64 compatibility, we have formatted and recorded 
programs on only one side of the disk. We will retain 
the same format onall future program disks as well. 

In order to avoid any possible accidents with your 
program disk, we suggest that you immediately 
place a write-protect tab on it, and back it up ontoa 
blank disk of your own. Then, use your backup 


during your studies. If any sort of accident should 
occur, you can still make another backup copy from 
your master disk. You are welcome to make as 
many copies of the program disk as you need to for 
your own use. However, please note that unless 
otherwise specified, the enclosed programs are 
copyrighted, and therefore must not be copied for 
anyone else. 

At various points in your Learning Guide, you will 
find instructions to turn on your computer. Since 
the C64 always starts in BASIC, all you have to dois 
turn on your computer and peripheral devices. You 
will always need at least one disk drive, and may also 
want to have a printer on-line and available for some 
demonstrations. If you have a C128 computer, you 
should switch to C64 mode before starting any of 
the demonstration programs. 

When your Learning Guide instructs you to go to 
the computer and RUN a particular program, you 
will need to LOAD it first, and then RUN it. 
Remember to specify device number 8 as you do so. 
For example, to start the first program and begin 
this module, type in the command sequence: 


LOAD “WELCOME” 8<return> 
RUN<return> 


and watch the resulting display on the screen. Note 
that the designation <return> means to press the 
RETURN key to end that particular command. 


MODULE 1 


Overview for the Commodore 64 and 128 Computers 


In this module, you will be working with a BASIC 
program designed to calculate payments and 
remaining balance for a standard declining-interest 
loan at any selected interest rate. However, by 
intent, there are several things wrong with this pro- 
gram as it stands. In the course of this module, you 
will correct a number of these errors. 

In addition, we have been able to include on your 
Program Disk some additional programs which are 
not a formal part of your Series. One of these, 
DEPRECIATION, will allow you to figure deprecia- 
tion of capital investments in different ways, and 
determine the most advantageous method for your 
own needs. This can often be useful for tax 
purposes. 

BACKUP will help you to generate backup 
copies of your disks by copying all active sectors 


(those in use by programs or data) to another disk. 
In fact, we advise that you start by backing up your 
program disk. 

KWIK LOAD is designed to speed up the loading 
of your disk programs. Since one of the most com- 
mon objections to the Commodore computers is 
the amount of time required for disk accesses, this 
can be a very useful utility. However, it gains this 
speed by disabling the video interrupt system dur- 
ing disk accesses, so the screen will go blank whe- 
never the computer calls the disk drive. In circum- 
stances where this is not acceptable, you should not 
use KWIK LOAD. 

These three programs are either in the Public 
Domain or else are User-Supported software. In 
either case, they may be freely copied and shared, 
but you may not charge for them. The remaining 
programs on your Program Disk are copyrighted as 
explained above. 

Now, you are ready to open your Learning Guide 
and enter the world of computer programming. 
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GETTING STARTED IN PROGRAMMING AND 
SOFTWARE DESIGN 


Contrary to a very common misunderstanding, the process of program- 
ming a computer involves far more than just sitting in front of the 
machine and typing in a series of instructions. In fact this process, 
known as coding, is really only a very small part of the complete soft- 
ware design procedure. The remainder of the programming process 
involves working primarily with paper and pencil, and very little time 
with the actual computer. This is probably the reason why many people 
don’t think of this kind of activity as programming. 

The real process of programming is a complete set of design pro- 
cedures for software. It begins with the conception of an idea, or the 
recognition of a problem, for which a computer solution is desired. It 
includes all of the steps required to define the computer's procedure to 
solve the problem or perform the desired task. 

Another common misconception involves the connection between 
programming and a computer language. Except for some minor details, 
the programming process is completely independent of any program- 
ming language. The connection occurs when the designed software is 
actually put into a form that may be entered into the computer. 
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In this Series, we will emphasize programming procedures and tech- 
niques. Programming examples will be provided in several common 
programming languages. However, the examples on disk will always be 
in either BASIC or in assembly language, since these are the only two 
languages available on a typical microcomputer. 

Although we will not be teaching any particular programming 
language, we will not assume that you have a very extensive knowledge 
of any one language. We will include descriptions of all instructions used 
in our examples. However, for full understanding of any one language, 
you will need a separate manual dealing with that specific language. As 
you progress through this Series, you will find that once you understand 
the basic process of programming, you will be able to readily apply the 
programming process to any language on any computer. Furthermore, 
you will find that you can quickly learn the behavior and syntax of a 
new language. 

In this module, we will explore the overall programming process, and 
define the key steps in this process. Then, in subsequent modules, we 
will examine each step in detail and apply the procedures to real, prac- 
tical examples. Although we will use many different kinds of programs 
as examples, financial and accounting programs will form the basis of 
many of our examples since they have universal popularity. In fact, 
before you have completed this module, you will develop a program to 
calculate payments and display the ongoing status of a declining interest 
loan. You will then be able to use this program to calculate payments 
for a new car, mortgage, or bank loan. 
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THE PROGRAMMING PROCESS 


If your computer is available at this time, turn it on and 
insert your program disk in drive #8. Then, type in the 
commands: LOAD “WELCOME”, 8<return> 
and RUN<return>. When the program ends, return to 
this point. 

The programming process consists of a number of 
steps. By taking these steps one at a time, you will 
find that the program almost writes itself, from start to 
finish. Figure 1-1 shows the basic steps involved in 
the programming process. Let’s look at each step in a 
bit more detail. 


Sector 1: Defining the Problem 


Before you can solve any problem, you must know 
what that problem is. Or, before you can perform a 
task, you must know what that task is. By the same 
token, before you can even begin to tell a computer 
what to do, you must know what you want it to do. 

In computer terms, this means that you must 
define the precise output data or operation you want 


MODULE 1 


from the computer. It is this end product that you will 
be aiming towards, so you must begin by defining 
exactly what end result you want from the computer. 

For example, suppose we want the computer to 
divide the number 15 by the number 3. Of course, 
this particular problem is simple, but it will illustrate 
the procedure. 


Sector 2: Defining the Solution 


Once you know what you want from the computer, 
you must determine what you have to start with, and 
how to get from the starting point to the end point. 
For the moment, you do not need to define the 
actual program steps or instructions. What is required 
is that you list all of the input data that will be available 
to the program when you do write it, and what 
mathematical or logical procedures the program will 
have to use in order to arrive at the desired final 
solution. 
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Defining Defining 
the the 
Problem Solution 


Debugging 
the 


Program 


This step is easily accomplished by first listing the 
input data and then listing the mathematical formulas 
and equations that will be required. Standard 
mathematical notations are entirely satisfactory here. 


Sector 3: Mapping the Solution 


Once you have defined the mathematical equations 
to be used in solving the problem or executing the 
desired task, you must restate these equations as 
logical sequences of computer operations. Normally, 
this means breaking down each equation or formula 
into a sequence of procedures using basic arithmetic 
procedures such as addition, subtraction, multiplica- 
tion, and division. If you know at this point the 
language that you will be using to code the program 
into the computer, you can break the equations 
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Program 
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Figure 1-1. The seven basic steps in the programming process. 


down into operations that are specifically built into 
that language. 

During this step, you also define the overall 
sequence of steps that the computer will follow to 
perform the task or solve the problem. It is at this time 
that you will draw flowcharts, diagrams, or other 
pictorial diagrams of the computer solution procedure. 


Sector 4: Coding the Program 


Now it is time to convert the predefined computer 
procedure into actual program statements. At this 
point, you must know the computer language that 
you will be using to implement the program. The 
actual computer language selected will be determined ) 
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by such factors as availability, required speed of 
execution, memory space available, etc. Regardless 
of the computer language, however, it is at this point 
that you use your flowchart or other pictorial solution 
as a guide in writing the actual program that will be 
entered into the computer. 

If the preliminary work has been done with the 
correct attention to detail, each flowcharted step will 
readily correspond to one or a few program instruc- 
tions. This will remain true even if you find it 
necessary to write the same program in two or more 
different languages. This is why it is helpful to keep 
the limitations and capabilities of the desired language 
in mind as you draw up the flowchart. 


Sector 5: Debugging the Program 


Any time programmers find that their programs run 
correctly the very first time, they chalk it up as a 
miracle. Programmers are human; they make mis- 
takes. Therefore, they run their programs a number 
of times, with different sets of test data, for which they 
know what the correct result should be. 

For each set of test data, the programmer deter- 
mines exactly what the program really is doing, as 
opposed to what it was supposed to do. Whenever a 
discrepancy appears, the programmer goes through 
the program listing and determines why the program 
is behaving the way it is. 

Each time an error is located and identified, it is 
corrected and the program is run again. Eventually 
the program will operate correctly for all of the test 
data. Then it can be put into actual service, to test 
it under working conditions for an extended period 
of time. 
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Sector 6: Documenting the Program 


This is the most often neglected phase of program 
generation. To document a program, you must write 
what is essentially an instruction manual detailing its 
use. This includes three basic parts: 


® The program listing — complete with explanatory 
comments that will make sense to another pro- 
grammer or to yourself at a later date. 


® A technical manual — describing the functions and 
purposes of the different parts of the program. 

* A user’s manual — describing the operation of the 
program on a day-to-day basis. 


Documentation is often neglected because the 
programmer can’t or won't take the time to do it or 
because it is regarded, at the moment, as unimpor- 
tant, since it does not contribute in any way to the 
operation of the program. A minimal user’s manual is 
generated, and nothing else. Unfortunately, this 
generally causes future problems, as we shall see 
next. 
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Sector 7: Updating the Program 


After a program has been in service for some time, 
there may be a need to modify or update it. This may 
be due to a subtle error that escaped the debugging 
process, or because of a change in the criteria from 
which the program was originally written, or because 
an additional function or capability is to be added to 
the program. 

This is where the need for proper documentation is 
realized. If the existing documentation is complete, 
it is a simple matter for a programmer to determine 
exactly where and how to add the new program 
module or modify the program to meet the new 
requirements. However, if the documentation is 
incomplete or missing, the programmer must first 
decipher the existing program, before making any 
design changes to it. In either case, the programmer 
must be at least moderately familiar with the language 
in which the program is written before any substantial 
changes can be made in it. Fortunately, the required 
knowledge of the language itself may be obtained 
from almost any book dealing with the language. 

Once the programmer has determined what 
changes to the program are required, he or she goes 
back to the beginning of the design process and 
makes the required design changes, just as the 
original program was designed and coded. 
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THE NEED TO UNDERSTAND PROGRAMMING 


Before the advent of the microprocessor, computers 
were large, expensive, and few in number. Each 
company, university, or government agency that had 
a computer had a small staff of programmers to go 
with it, and no other programmers were required for 
any purpose. Most of the population had no access to 
a computer and no way to learn how a computer 
worked. 

As semiconductor technology advanced, vacuum 
tubes gave way first to transistors and then to 
integrated circuits. As a result, computers became 
much smaller and less expensive. These smaller 
computers were known as “minicomputers,” and 
while they generally had less capacity than the older 
mainframes, they were still quite satisfactory for a 
wide range of applications. The spread of mini- 
computers required additional programmers, but 
most of these were still “captive” to their specific 
machines. 

As integrated circuits became more complex, the 
single chip microprocessor evolved, as did high- 
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density memories. Thus, the microcomputer was 
born. Today, computers are small and affordable, 
and appear virtually everywhere. Any business and 
almost any homeowner can afford a computer with 
greater capacity and capability than most of the early 
mainframe computers. The widespread proliferation 
of computers has spawned a critical need for pro- 
grammers, who are still in short supply. 

In the past, almost anyone who used a computer 
had to know something about programming, or else 
be restricted to using someone else’s program. This 
still holds true. The difference today is that with the 
vast number of computers available, there are many 
people using the same program, each on his or her 
own machine. The same program cannot serve 
everyone’s needs precisely, and one programmer 
cannot modify a program to suit thousands of in- 
dividual needs. With this in mind, let’s take a look at 
those who can benefit from knowing how to do their 
own programming. 
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Sector 1: The Home Computer Owner 


An individual may purchase a home computer for 
any number of reasons. A very common reason is for 
playing computer games. Another is for educational 
purposes. Other uses include the management of 
household finances, or maintaining telephone 
numbers, Christmas card lists, recipes, etc. 

Very quickly, the games may become boring, as 
do the educational programs. The household utility 
programs usually do a “pretty good job, but would be 
better if...,” and the same is true of most other com- 
mercially available programs. Very often, owners of 
home computers cannot even find programs dealing 
with the particular subjects they really want. Or, such 
programs are available, but only for different (incom- 
patible) computers. 

At this point, the owners of home computers must 
either learn how to design their own programs, or 
else remain at the level of using programs designed 
by others. Even if the owner wants to just modify 
existing programs, an understanding of the 
programming process is a must. 


Sector 2: The Office Computer User 


The office computer user most commonly will use either 
a word-processing or a data-processing program, or pos- 
sibly a computer dedicated to one of these two applica- 
tions. Such a person may never need to know the details 
of the programming process. However, a general under- 
standing of programming will still enable this person to 
make the fullest possible use of the program. 
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Furthermore, by learning the techniques of pro- 
gramming, this type of user can open the door to 
greater responsibility and a higher paying job. 


Sector 3: The Manager / Supervisor 


Any manager or supervisor of one or more program- 
mers also needs to understand the general program- 
ming process, and what the machine can and cannot 
do. Without this knowledge, the supervisor cannot 
specify clearly what the programmer is to do, nor 
clearly understand the results obtained by the 
programmer. 

As with the office computer user, the manager 
does not really require a large amount of program- 
ming knowledge, but does require enough to be able 
to understand what the programmers in the depart- 
ment are doing. Otherwise, the manager cannot 
supervise them effectively. 


Sector 4: The Small Business Owner 


The owner of a small business is in a position similar 
to that of a manager or supervisor of programmers. 
The business owner will generally purchase a com- 
puter system complete with custom software. This 
software is written or modified by the computer sup- 
plier to conform with the business owner’s specific 
requirements. 

The problem here is that the computer supplier 
probably knows very little, if anything, about the 
business conducted by the small business owner. If 
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the owner, likewise, knows nothing about the program- 
ming process, and therefore will not be able to clearly 
specify just how the program is to operate. As a result, 
the computer program will probably be inadequate for 
the task, and will have to be modified, rewritten, or simply 
scrapped. 

The rewriting of software is both expensive and time 
consuming. Furthermore, if the owner still is not familiar 
with programming procedures and requirements, the 
rewritten software will probably still contain some prob- 
lems. On the other hand, if the owner does understand 
the programming process, the program will probably 
work better to start with, and the owner will be able to 
make any required small adjustments without help. 


Sector 5: Looking to the Future 


The present trend in technology is to have pre- 
defined, repetitive tasks performed by machinery 
rather than by hand. For example, the welding of 
automobile frames and bodies is now often per- 
formed by robots, rather than by human workers. 
Other assembly stages are also performed auto- 
matically, and the trend is continuing in this direction. 

In machine shops, numerically controlled (NC) drill 
presses, lathes, milling machines etc. are becoming 
ever more common. Sheet metal work and wood- 
working are moving in this same direction. In fact, 
any kind of task that can be defined precisely can be 
performed by a computer-controlled machine. Such 
a machine will be able to repeat its task exactly, an 
indefinite number of times, without making errors. In 
addition, it will generally be able to perform the task 
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faster than a human, and without taking any breaks, 
vacations, or sick leave. 

This ongoing trend is causing a reduction in the 
number of so-called “blue collar” jobs available, as 
machines take over the tasks that call for heavy 
physical labor or tedious repetition. Clerical work and 
record keeping are likewise being performed more 
and more by computers, as are tasks such as 
inventory maintenance and scheduling. 

However, while the computer is taking over many 
jobs in this portion of the marketplace, it is simul- 
taneously creating a large number of job openings in 
other fields. With so many computers at work, there 
is a growing demand for people who can design, 
write, and maintain programs for them. Thus, the 
more you know about computers and computer pro- 
gramming, the more choices you will have in the job 
market, and the greater will be your potential for 
advancement in industry. This will become more 
and more the case as computers and automatic 
machinery perform more of the predefined, repetitive 
tasks in industry. 
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THE RELATIONSHIP BETWEEN THE COMPUTER 


AND ITS PROGRAM 


Most electrical and electronic devices are considered 
to be dedicated appliances. That is, they are 
specifically designed and constructed to do one job 
and no other. When you turn on such an appliance, 
it immediately begins performing that task. 

For example, if you turn on a dishwasher, it im- 
mediately starts washing whatever dishes are inside it. 
When you turn on a television set, it displays picture 
and sound for whatever channel it is tuned to. The 
same logic holds true for a radio, a toaster, or any 
other appliance you can name. 

A computer, however, does not work this way. 
The computer is not limited to a single task or func- 
tion. Rather, it can perform a wide range of tasks, 
depending on what is wanted at the moment. The 
computer cannot perform its task until it receives a set 
of instructions defining the task to be performed. 
When you turn on the computer, it goes through an 
initialization procedure, and then displays a 
“prompt.” It then waits for the operator to enter a 
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command or load a program. 

With these points in mind, let’s see just what the 
computer and its program are, and how they work 
together. 


Sector 1: What Is a Computer? 


As we said above, a computer is a nondedicated 
appliance. As such, it can do a wide range of tasks, 
but it must first be supplied with instructions to define 
the current task. The computer itself is a machine that 
is capable of executing a sequential list of instructions 
stored in its memory, one at a time. 

If your computer is available at this time, turn iton and 
insert your program disk in drive #8 if necessary. Then, 
LOAD “TRACK3",8<return> and RUN<return>. Do 
not turn off your computer when it directs you to return 
to this point in the Learning Guide — you will be going 
back to the computer shortly. 
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Modern computers contain special programs in read 
only memory (ROM), which are executed automatically 
when you turn on your computer. This includes a short 
routine that initializes the computer and its peripheral 
devices, checks on how much memory is available for 
user programs, and then proceeds to the main operating 
system. 

In many computers, the operating system is loaded 
from disk, and resides in part of the user memory. In the 
Commodore 64, BASIC is in ROM, and the computer 
automatically starts up in BASIC when you turn it on 
(unless you have a cartridge present, in which case its 
ROM is executed instead). 

Once the computer has completed its initialization, it 
displays its READY. prompt and waits for your input. 


12 


This takes the form of keyboard input. Even to load a 
program from the disk, you must first type in the com- 
mand to do so. The program you load may be written in 
either Commodore BASIC or in machine language, 
depending on how it was created and saved. Once the 
program has been loaded, you will normally see the 
READY. prompt on the screen again, showing that the 
computer has completed its task and is waiting for further 
user input. 

Throughout this process, the computer performs 
all of these tasks. However, in every case it is a 
program that tells the computer what task to perform. 
Without a program, the computer is utterly helpless 
and useless. It can only sit and wait to be told what 
to do. 


Sector 2: What Is a Program? 


Both the operating system and BASIC that we 
described above are programs. A program is nothing 
more than a list of instructions for the computer to 
carry out. It is this list of instructions that tells the 
computer exactly what to do, on a step-by-step basis. 

A computer program is not the only kind of pro- 
gram in existence. In fact, everyone is familiar with 
programs in one form or another. For example, a 
recipe is a program. That is, the recipe contains a list 
of the ingredients required to make, for example, 
chocolate chip cookies, along with the exact pro- 
cedure to follow to turn the ingredients (flour, sugar, 
etc.) into the finished product (cookies). 

Another kind of program is the set of directions 
you might follow to get to a friend’s house. The inter- 
section identifications and counts, the series of right 
and left turns, the street names and house numbers, 
distances, etc., all constitute a program with data that 
you must execute in order to find your friend’s house. 


MODULE 1 


CTF 


a 


Introduction to Programming and Software Design 


Track 3 


eee 


In exactly the same way, a computer program is 
nothing more than a list of instructions for the 
computer to carry out. It will generally contain many 
more instructions than a recipe or directions to a par- 
ticular house. However, the basic principle is exactly 
the same. 

If your computer is available, go back to it now, 
and press the space bar as specified on the screen. 
Return to this point when you are instructed to do so. 


Sector 3: The Computer and Its Program Working 
Together 


We have seen that a computer without a program 
cannot accomplish anything. By the same token, a 
computer program without a computer is not useful. 
The two must work together in order for anything 
worthwhile to happen. 

Recall that a computer is a nonspecific appliance; it 
requires a list of instructions to follow, to tell the 
computer exactly what to do. This list of instructions 
is the computer program, which is loaded into the 
computer’s memory. With its program in place, the 
computer can proceed to execute the instructions in 
the list, on a one-at-a-time basis. 

With the proper program, the computer (within its 
own limitations such as memory size, etc.) can 
accomplish virtually any desired task, no matter how 
simple or complex. It is the program that directs the 
operation of the computer in every detail. As a result, 
the basic job of any programmer is to define for the 
computer the exact sequence of operations to be 
performed in order to accomplish the task. 
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Of course, some specialized applications will 
require that certain hardware be connected to the 
computer before the computer can execute specific 
tasks. For example, you cannot get the computer to 
dial a phone number unless it has a connection to the 
phone line and has either pulse or Touch-Tone™ 
capability. Likewise, the computer cannot tell the 
present time or date unless specialized circuits have 
been installed to maintain this information. However, 
with the required hardware in place, a program can 
be designed to accomplish the desired task. 
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The primary difference between a computer pro- 
gram and other types of instructions such as recipes 
or directions is that the computer program cannot 
take anything for granted. For example, a recipe will 
not warn you to open the oven door before inserting 
the cookie sheet. It is assumed that the baker will 
know when to open and close the oven, and how to 
avoid burning his or her fingers. The computer, how- 
ever, will take nothing for granted and will make no 
assumptions. It will do exactly (and only) what its 
program specifies. Furthermore, the computer will 
execute its instructions in the exact order in which 
they are written in the program. Thus, if the program 
instructs the computer to put the cookie sheet in the 
oven, then open the oven door, then close the oven 
door, you will wind up with cookie dough on the 
floor. You must even specify that the computer 
releases the cookie sheet once it is in the oven. 

For this reason, programmers must not only think 
about the computer procedure while they are design- 
ing the program, but they must test the operation 
of the program and make sure that everything is 
performing correctly. 

Fortunately, this process is not really as difficult as it 
may sound. Computers are entirely logical in their 
behavior, so problems normally appear where the 
programmer was not thinking logically, or assuming a 
factor, and therefore left out a key step in the instruc- 
tion sequence. You will begin to quickly recognize 
the common sources of these problems, and be able 
to either avoid them altogether or correct the 
problem. 
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HOW DOES A PROGRAM RELATE TO THE 


COMPUTER'S BEHAVIOR? 


If you have been using your computer while studying this 
Learning Guide, the last BASIC program from Track 3 
should still be present in the computer’s memory. Type in 
the command line: List 100-290 <return>. This will dis- 
play a portion of the last program executed by your 
computer. 

Figure 4-1 shows this portion of the program listing for 
the Commodore 64 computer. Let’s take a look at it in 
detail. 

Each line of the program has its own unique line 
number. This is standard for all programs written in the 
BASIC language. Program lines are placed in memory in 
numerical order, and are executed in the same sequence. 
A good practice is to use a group of line numbers for a 
particular task, and then use another set of line numbers 
for the next task. Thus, in this listing, we have four groups 
of line numbers to perform three individual tasks within 
the overall program. We will consider each task sep- 
arately. 
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Sector 1: Lines 100 through 120 


The first three lines in the 100’s are used to reverse the 
foreground and background colors, clear the screen, and 
predefine two cursor motion character strings. 

Some versions of BASIC permit you to locate the 
cursor wherever you want it with a modified PRINT 
command, such as PRINT@. Other BASICS use the 
command LOCATE, to define the row and column 
where the cursor is to be placed. Commodore BASIC 
uses cursor motion keys, which are represented in Figure 
4-\ as[CD] for Cursor Down and [CR] for Cursor Right. 
The [CS] tag in line 100 represents the SHIFT-CLR key. 
The subroutine starting at line 900 (see Figure 4-2) uses 
parts of these two strings to locate the cursor at any 
desired point on the screen, and then print a character 
string. The location and the string will be placedin DATA 
statements in the program. 
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UTE 


late 


LOSE ORE: See... 14S FORE 646. 62 PRINT Oto) ag 


1190 DS="CEDIECCDICCDILCECDILCHILCCDILECDILECDICCDICCDICCDICCDICCDICCDICCDICCDICCDILCCDI 


CEDIFERDIEEDILECDICCHITCDILCHI™ 


120 ASS oC EREPCR IL EA TEER PCR ALERT PERE GRAECRICCRILCRICERJ ECR CORILERIECRIECRIEEGRI 
PCRICCRILCRICTCRICCRICCRICCRIECCRILCRIECRICCRALCRICCRICCRI ECRJEGCRILERILCRILCRIEERI 


Sf | vi = Ne 

5O REM WRITE HEADER LINE 
160 GOSUE Yoo 

170 FOR T=1 TO 1500:NEXT I 
200 REM DRAW RECIFE CARD 
210 GOSUB oo 

220 FOR [et To Sow eNEs yr of 
now GOUSUR See 

240 FOR I=1 TQ 2000:NEXT I 
220 REM DRAW STREET MAF 
260 GOSUB SOO 

270 - FOR T=1. TO SOGHNEST TF 
2o0 GOSUER 9O0 

290 FOR I=1 TO 2OOO0:NEXT I 


Sector 2: Lines 150 through 170 


These program lines write a title or header line at the top 
of the screen, and then cause a brief time delay. 

The REM statement says that line 150 is just aREMark; 
it will be ignored by the computer when it executes this 
program. REM statements are placed into programs to 
help explain the purpose of different sections of the pro- 
gram. They are listed as you see, but do not change the 
way the program works. 

Line 160 simply tells the computer to execute the 
subroutine at line 900. It is this subroutine that will actu- 
ally place the header line on the screen. When it has done 
so, it will return control back immediately following the 
GOSUB command. 
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Figure 4-1. Part of a BASIC program. 


In this case, control returns to line 170, which produces 
atime delay. Normally, the FOR command tells the com- 
puter to execute a sequence of instructions a certain 
number of times. The last statement in the list will be a 
NEXT command. In this case, there are no instructions 
between FOR and NEXT, so no instructions get exe- 
cuted, and the computer simply wastes a little time before 
going on. 

In the subroutine, shown in Figure 4-2, line 910 reads 
the line number on which the character string is to be 
placed. For this purpose, the top screen line is consi- 
dered to be line 0. The READ command tells BASIC to 
find this value ina DATA statement located somewhere 
in the program. Figure 4-2 shows the first of the DATA 
statements used in this program. 
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900 REM LOCATE/DRAW SUBROUTINE 
910 READ X:IF X<#0 THEN RETURN 
920 READ Y,CS 


9230 PRINT" CHC]";LEFTS (D&, X) sLEFT# (R&, Y) 3083 


940 GOTO 910 
1000 REM HEADER LINE 


1010 DATA ©,2,"A PROGRAM IS A LIST OF INSTRUCTIONS. ",-1 


Figure 4-2. The cursor location subroutine and header data. 


The subroutine is designed to be able to place any 
number of lines or blocks of information on the screen 
without stopping. Therefore, we use the line number asa 
“flag” to tell BASIC when to leave the subroutine and 
return to the point from which the subroutine was called. 
If the line number is positive (or zero), it is used as the 
display line. If it is negative, the subroutine ends. This 
checking is accomplished by the IF statement on line 910. 

The colon (:) on line 910 tells BASIC that another 
command is coming up at once, without a new line 
number. Commodore BASIC permits you to string any 
number of commands together this way, so long as they 
all fit in 80 characters (two screen lines). 

If the line number was positive, line 920 goes back to 
the DATA statement to read the desired column number 
and the character string itself. Then, line 930 homes the 
cursor before using the LEFT$ function to isolate just the 
desired part of the two cursor motion strings we defined 
in lines 110 and 120. Once the cursor has been moved, 
the actual character string is printed. 

Finally, line 940 tells BASIC to go back to line 910 and 
try for more data. In this case, BASIC finds a line location 
of -1, so it leaves the subroutine and returns to the 
GOSUB command which called the subroutine. 


Sector 3: Lines 200 through 290 


These program lines perform the same functions as lines 
150 through 170. However, each time the subroutine is 


MODULE 1 


executed it will go on to the next DATA statement or 
element, so we won't just have the same line displayed 
over and over again. Also, each of the two pictures is 
drawn in two sets of DATA statements, with a slight 
pause in between. This slows down the computer a little 
and makes the display easier to follow. 


Sector 4: The Program and Computer Operation 


Each command in a computer program is an instruction 
that tells the computer to do something. As we stated in 
line 110, a program consists of a list of such instructions. 
The computer executes these instructions in sequence 
when told to do so. The specific instructions for a given 
program are selected to cause the computer to perform 
the desired task, one step (instruction) at a time. 

If your computer is available at this time, RUN this 
program again. Since it is already present in memory, no 
program name will be required; simply type RUN 
<return>. Observe the operation of the program, and 
compare that operation with the program listing we 
studied above. Does the computer actually carry out 
these instructions in the sequence indicated? 
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DESIGNING A NEW PROGRAM 


Earlier, we stated that there are seven basic steps in 
the overall programming process. These are: 


Defining the problem 
Defining the solution 
Mapping the solution 
Coding the program 
Debugging the program 
Documenting the program 
Updating the program 


Of these steps, the first three constitute the original 
design phase of programming. In these three steps, 
the programmer starts with the initial problem state- 
ment and transforms it into a step-by-step procedure 
that describes the computer solution. The computer 
language has not yet been defined, nor has the actual 
machine been specified. The procedure produced by 
the design phase of programming is generic. That is, 
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it applies to any computer, using any programming 
language. 

With these points in mind, let's go through the 
design phase of programming for a practical, real-life 
program that can affect everyone in any walk of life: 
the declining interest loan. This is the type of loan that 
you get from a bank or credit union, as a personal 
loan, car loan, home mortgage, etc. Let’s design 
such a program right now. 

If your computer is available, LOAD “TRACK5”, 
8<return> and RUN<return>. Return to this point 
when your computer instructs you to do so. 


Sector 1: Defining the Problem 


Before we can begin designing the computer solution 
to this problem, we must know exactly what we want 
the computer to do for us. Therefore, we will start 
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by listing the exact information we will want the 
computer to produce: 


e The regular payment amount 

e The payment number in sequence 
¢ The amount of interest paid 

¢ The amount of principal paid 

¢ The remaining principal balance 


We should also decide how often the payment will 
be made. Normally, payments are made monthly 
rather than quarterly or annually, so we will set up 
our design for monthly payments. The payment will 
be the same every month, so this need only be 
calculated and stated once. However, each month 
the amount of principal and the amount of interest 
paid will change, so we will want to list these values 
for each month in sequence. Likewise, the balance of 
principal remaining to be paid will decrease at an 
accelerating pace, so we will want to include this 
value for each payment. 

We don't really have to decide on the display for- 
mat for this data yet, but if we do, it may help us to 
make sure that we haven't overlooked something we 
want to include. For example, at the top of the screen 
we can place a header, column titles, and all data that 
remain constant. We should also include the amount 
of the loan, the interest rate, and the overall duration 
of the loan. These will be inputs, but we will want 
them on the screen, for comparison purposes. Other- 
wise, we might forget a key factor when comparing 
loans. Figure 5-1 shows a practical layout that will 
allow us to display a full year on the screen. 


Figure 5-2 summarizes the considerations that 
should be made when defining the problem to be 
solved by the computer. 


Sector 2: Defining the Solution 


Now that we know that we want the computer to do 
for us, it is time to start deciding how to tell the com- 
puter to do the job. The first step is to list all of the 
mathematical equations and procedures that we will 
need, and the initial data that we will require. 

We must start with three basic input values: the 
amount of the loan itself, its duration (how long we 
will have to pay it back), and the interest rate. Let’s 
see how far we can get with these three values; if we 
need further inputs, we will find out soon enough. 
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The primary calculation is the amount of the 
monthly payment. The mathematical formula for this 
is: 


Regular Payment = 


1- (+-+ 


where: i = annual interest rate 
P = the original principal, or amount of the 
loan 
N = the number of payments per year 


by 


the number of years for the loan. 


Later, we will rearrange this equation for easiest 
implementation on the computer. For now, let's list 
the remaining equations we will need: 


i 
Interest on a payment = —— x current 
N _ principal balance 


Principal on a payment = payment — interest on 
payment 
These two equations show how the amount of any 
one payment is split between interest on the remain- 
ing balance and principal paid toward that balance. 
The interest is always taken out of the payment first; 
the remainder goes to the principal. 


New principal balance = old balance — payment on 
principal 


This simply subtracts the current principal payment 
from the steadily decreasing principal balance. The 
interest for the next payment will be calculated on the 
new principal balance. 
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Figure 5-3 shows the basic steps that should be 
taken in order to define the solution itself. Note that 
we have not defined the actual computer procedure 
yet; we have only defined the mathematical and 
logical procedures to be performed by the computer. 


Sector 3: Mapping the Solution 


At this point, we know the output data the computer 
is to provide, the input data that we must supply to 
the computer, and the mathematical equations that 
the computer must solve in order to produce the 
desired output. Now it is time to organize the com- 
puter’s procedure, and list that procedure as a se- 
quence of individual steps. 
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Figure 5-4 generalizes the requirements of this 
stage in the design phase of programming. At this 
point, we must define the computer’s solution pro- 
cedure in terms of individual steps. The list of steps 
will define the exact sequence of operations to be per- 
formed by the computer. 

The first requirement is to list the computer pro- 
cedure in sequence. The idea is to define, not only 
what the computer must do, but also which step 
comes first, second, third, etc. For this problem, our 
first list might be something like this: 


Input the initial data. 

Calculate the regular payment. 

Calculate the interest on the loan balance. 
Determine the amount of payment to go to 
principal. 

Determine the new loan balance. 

Display results for this payment. 

Repeat steps 3 through 6 for all payments. 

End the program. 
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This list describes the required operations, but does 
not detail each step. At this point, we can either add 
more detail to this list, or we can go directly to a more 
pictorial description, such as a flowchart. It is gener- 
ally a good idea to fill in as much detail as possible 
before going to a flowchart or other pictorial repre- 
sentation, simply because a flowchart takes a while to 
draw or redraw. The fewer times it must be redrawn, 
the better. Nevertheless, it should not be skipped, 
because it does present the computer solution 
procedure in a very clear manner. 
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Figure 5-5 shows the preliminary flowchart that 
corresponds to the listed steps above. In_ this 
flowchart, we have shown boxes of four different 
shapes. The shape of the box is used to denote the 
type of function performed in that step. Then, the 
exact operation is written within the box. 

Let’s look at Figure 5-5. The oval boxes at the top 
and bottom are used to designate entry and exit 
points. In this case, we use them to designate the 
starting and ending points of the program. The 
parallelograms (boxes with slanting sides) specify 
input and output operations. The first one calls for 
inputting the initial data required by the program, 
while the second one indicates the data to be output 
by the program. 

The rectangular boxes indicate processes. These 
are calculations and operations entirely internal to the 
computer. Finally, the diamond is used to indicate a 
decision. Here, the program must decide whether 
or not it has displayed the payments for all of the 
months specified by the user during the input phase 
of the program. Note that the possible decisions or 
answers are explicitly labeled on their separate output 
lines. Decisions are most commonly expressed as 
questions with YES or NO answers. In some cases, 
the decision involves a comparison with three possi- 
ble results, such as AC B, A=B, or A> B, depending 
on whether A is less than, equal to, or greater than B, 
respectively. In this case, there will be three output 
lines from the decision box, and each line will be 
labeled appropriately. 


INPUT; 
LOAN AMOUNT 
INTEREST 


RATE 
NO. OF MONTHS 


CALCULATE 
REGULAR 
PAYMENT 


CALCULATE 
INTEREST PYMT. 
PRINCIPAL PYMT. 

NEW BALANCE 


OUTPUT: 
PAYMENT NO. 
RESULTS OF 
CALCULATIONS 


ALL 
PAYMENTS 


DISPLAYED 4, 
2 ; 


The lines from box to box indicate the logical flow 
“~~ of the program. In most cases, each box has one line 


Figure 5-5. The first-round flowchart for the 
Declining Interest Program. 
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leading to it from the previous box, and one line 
going out to the next box. Thus, the program flow is 
straightforward. In the case of a decision, there are 
generally two or three outgoing lines. The program 
flow will then follow the line that corresponds to a 
particular outcome from the decision. These lines 
must be clearly labeled according to outcome, so that 
the program flow remains clear for all possibilities. 

At this point, we would normally extend the flow 
chart, or the list of steps, to include all of the formulas 
to be used and each exact step in the computer pro- 
cedure. Remember, the more detail we include here, 
the easier it will be to code the program, which 
is the next step. We might also use other pictorial 
approaches to try to describe the program operation 
in a clearer format. 

However, for the purpose of this overview, we can 
proceed directly to coding the program, which is the 
next step in the programming process. 


R 
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Although our flow chart really isn’t as complete or 
detailed as it might be, it is still sufficiently detailed 
so that we can see the correlation between the 
flowchart and the coded program. For the purpose of 
our overview, we will proceed to the coding phase, in 
which we will actually enter the program into the 
computer. 

Coding is one step in the programming procedure 
that requires a working knowledge of the computer 
language to be used. This is the stage where the pro- 
gram is actually entered into the computer. For 
demonstration purposes we will use BASIC, because 
most computer users are at least somewhat familiar 
with this language. However, as we progress through 
this course, we will define and describe each new 
BASIC command as we introduce it. We will also 
describe any command in other languages that we 
might use for illustration purposes. 

To start you off, we have included the initially coded 
program on the disk supplied with this module. If you 
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have your computer available, type in the command: 
LOAD“LOAN”,8 <return>. Now you can follow the 
program listing on your computer as well asin the follow- 
ing text and figures. 


Sector 1: Inputting the Initial Data 


Figure 6-1 shows the program lines 100-199 that deal with 
inputting data at the start of the program for the Com- 
modore computer. 

If you have your computer available and have loaded 
the LOAN program, type in the command: LIST 100-199 
<return>. This will cause the computer to display on its 
screen the program lines that deal with inputting data at 
the start of the program. 

This group of program lines performs the operations 

specified in the INPUT box following START in Figure 
5-5.Line 100 clears the screen (CS) so that the display will 


25 


Introduction to Programming and Software Design 


not contain any irrelevant lines or characters. It then 
places a title line in the middle of the top line of the screen. 
Such a title is helpful to a program user, so that he or she 
knows what the program is intended to do. 

The remaining program lines in this group 
request three items of information from the user: the 
initial amount of the loan, the interest rate, expressed asa 
percentage, and the number of months over which the 
loan is to be paid off. We have used variables to store 
these values in the computer’s memory. To help describe 
them, we have named them according to what they 
represent. Thus, LO is a variable holding the initial value 
of the loan. IR is another variable to hold the interest rate, 
and NP is a third variable to hold the number of monthly 
payments that will be required to pay off the loan. 

Some versions of BASIC will recognize 6 or 8 or more 
characters per variable name, while others only recog- 
nize a single character. Commodore BASIC recognizes 
oneor two-character names, of which the first character 
must be aletter and the second must be either a letter or 
a number. Additional characters are permitted, but will 
not be recognized as being part of the variable name. 
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Thus, we could say LOAN instead of LO, and perhaps 
IRATE instead of IR. However, the computer would only 
remember the first two letters. 

Be careful if you use more than two characters. BASIC 
will recognize V11 and V12 as being identical. It will also 
look for keywords in the rest of the variable name. Thus, 
the variable names TOP and BOTTOM will both pro- 
duce syntax error messages, because they contain the 
reserved keyword TO (used in FOR statements). We 
suggest that you stick with one- or two-character variable 
names in your programs to avoid such problems. 

In either case, the INPUT command works in the same 
way. This instruction tells BASIC to first print out any 
quoted message following the word INPUT, and then 
wait for the user to type something in and press 
the <enter> or <return> key. Then, whatever the user 
typed in before pressing the <return> key is stored in 
memory, where it can be accessed later. The variable 
name at the end of the INPUT command line is used as a 
tag, or label, to identify that particular data item. Once a 
variable has been defined and stored with its name tag, it 
may be accessed at any time just by using its name ina 
calculation. Also, it may be changed, or redefined, at any 
desired time, which is why it is called a variable. 

When all three initial values have been received 
and placed in memory, this part of the program is 
done, and BASIC continues with the next line in 
numerical order. 


100 PRINT"COSICCRICCRIREFAYMENT OF DECLINING INTEREST LOAN" 


110 INFUT"CCDIAMOUNT OF LOAN";LO 
120 INFUT" INTEREST RATE (EG, 


Piao Ss DR 


130 INFUT"DURATION OF LOAN IN MONTHS"; NF 


Figure 6-1. The INPUT segment of the LOAN program. 
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Sector 2: The Preliminary Calculations 


Figure 6-2 shows the next group of program lines, 
numbered in the 200’s. Note that each logical section 
of the program is assigned its own group of line 


numbers. This leaves a reasonable amount of space 
for future program modifications. You should always 
assume that modifications will be needed, and leave 
some space for them. For the same reason, the initial 
program line numbers count by 10’s, leaving room 
for extra lines to be placed between them. //he 
command: LIST 200-299 will display these lines on 


your computer. 


Track 6 


The first step in this stage is to convert the annual 
interest rate, expressed as a percentage, to the monthly 
interest rate, expressed as a decimal fraction. To convert 
from percentage to decimal fraction, we divide by 100. 
This changes the interest rate from 11.5% to 0.115, for 
example. Next, we divide by 12 to change from annual 
rate to monthly rate. Putting both factors together, we 
can simply divide IR by 1200 to get the monthly rate, MR. 

In line 210, we can now use MRas the fraction i/N in the 
main equation for calculating the monthly payment. Line 
210 performs this calculation to produce PM. Note the 
use of parentheses to force the desired order of calcula- 
tion in this formula. Without the parentheses, BASIC 
would first handle the exponent (denoted by the * sym- 
bol), then the multiplication (*) and division (/), and finally 
the addition (+) and subtraction (-). The use of paren- 
theses bypasses the assumed order of precedence, and 
forces calculations to be performed in the desired order. 


200 MReIR/1200 
210 FM = (MRXLO)/ (1—(MR+1) “NPD 
220 BA = LO 


Figure 6-2. The initial calculations for the LOAN program. 


SS 


200 PRINT" CCSICCRICCRICCRIREFAYMENT OF DECLINING INTEREST LOAN" 


210) PRINTIPRINT'REPAYING $°2LOs "AT": IRs % 


“res yy FRINT FOR" SNPs "MONTHS, ” 


30 PRINT:PRINT"MONTHLY PAYMENT = $";PM 


INTEREST” 


240 PRINTSPRINT' MONTH", "INTEREST" ."PRINCIFLE", "BALANCE" 


a 


‘hal an 
‘ae New | 
LiVSICAPSICTSSICISSICAISICLPSICIVSICAPSICLSSICASSILISSICPSSICISSICL9SILISSIC 


DIGS TEP S IC TES ICAO SILA Sel PSI CLS 161 eS 


Figure 6-3. Setting up the video display. 
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Line 220 simply predefines the BAlance, which will 
gradually decrease from the value of LOan to zero as we 
pay off the loan. 


Sector 3: Setting Up the Output Display 


Before we begin the repeated payment calculations, 
we want to set up the display format suggested in Figure 
5-1. This is the purpose of the group of program lines in 
the 300’s, shown in Figure 6-3. Youcan display these lines 
by typing LIST 300-399 <return>. 

The first step is to clear the screen as we did before. 
We do want to keep the main title at the top of the 
screen, but nothing else, and it is easier to simply 
retype this line than it is to try to erase the remaining 
lines one at a time. 

The remainder of this program segment is merely 
a series of PRINT statements designed to format 
the output display and prepare for the coming 
calculations. 


Sector 4: The Main Program Loop 


The program lines in the 400’s (LIST 400-499 <return>) 
are shown in Figure 6-4. This group of lines performs the 
main calculations and displays the results, one month at a 
time. 

Since this is to be a sequence of repeated operations, 
we set up a FOR ... NEXT loop to do the job. The FOR 
statement in line 400 uses MOnth as the main index 
variable, and specifies that we will count from 1 to NP, so 
that we will pass through the loop once for each monthly 
payment to be made. The last line in the group is a NEXT 
MOnth statement, to close the loop and force the com- 
puter to repeat the remaining lines the desired number of 
times. 

The first requirement is to figure the INterest for this 
payment (line 410). Then, (in line 420), we can subtract 
INterest from the calculated Payment to find out how 
much we will pay toward PRincipal. Finally, (line 430), we 
can reduce the BAlance by the current PRincipal pay- 
ment. This completes the required calculations for the 
current monthly payment. 


400 FOR MO = 1 TO NF 
410 IN = BA x MR 

420 FR = FM = IN 

420 BA = BA - PR 

440 PRINT MO; INsFR:BA 
450 NEXT MO 


Figure 6-4. The main program loop. 
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10 REM CONTEMPORARY SOFTWARE DESIGN 


Tea Ret MODULE 1 
=O REM 


2a REM DECLINING INTEREST LOAN FROGRAM 


20 REM 


=o REM INITIAL PROGRAM TO BE EXTENDED 


40 REM AND CORRECTED BY THE STUDENT 


oS REM 
20 REM MCGRAW-HILL 
25 REM CONTINUING EDUCATION CENTER 
60 REM 2929 WISCONSIN AVENUE, NW 
62 REM WASHINGTON, DC 20016 
79 REM 
BO REM 
90 REM 


Figure 6-5. The preliminary comments for the program. 


Line 440 uses the PRINT command to display the 
results of the calculations for this particular MOnth. This 
time we don’t have any quoted character strings to dis- 
play. Instead, we just want to display the current values 
for MOnth, INterest, PRincipal, and BAlance. BASIC will 
retrieve these values from memory and display them in 
the specified order. 

Note the use of semicolons (;) between these variable 
names. The semicolon tells BASIC that the next item to 
be printed should be placed exactly where the previous 
item ended. Numbers are formatted with a trailing space, 
so they won’t run together. We could use a comma (,) to 
tell BASIC to line up these values in columns, but the long 
numbers displayed would cause each display line to 
occupy two screen lines if we did this. Later, we will see 
how this can be done correctly. The absence of any 
punctuation, such as at the end of line 440, tells BASIC to 
end this line and proceed to the start of the next line. This 
constitutes a “carriage return and line feed” 
combination. The proper use of punctuation in PRINT 
statements is helpful in formatting the visual display. 
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Sector 5: Identifying the Program 


One remaining item, which many new programmers 
overlook, is an identification of some kind within 
the program listing. This identification need not be 
extensive, but it should name the program, and if 
appropriate, specify what the program is part of. 

This kind of identification is part of the documenta- 
tion of the program, which appears as Step 6 in the 
overall programming process. However, a small 
amount of documentation in the form of a few 
remarks at the start of the program listing can be very 
helpful. Figure 6-5 shows the remarks we placed at 
the start of the LOAN program. 


Remarks in BASIC are comments that are not exe- 
cuted by BASIC. They are denoted by the command 
keyword REM, or in some versions of BASIC, by an 
apostrophe (‘). Remarks are included as desired in any 
BASIC program to describe the purpose or operation of 
the program as a whole or any part of it. We will deal with 
remarks in more detail later. 
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TRACK 7 


Testing and Debugging 
the Program 


/ The Test Run 


/ Identifying and Correcting 
the Problem 


V/ Cleaning Up the Display, 
Stage 1 


"4 Cleaning Up the Video Display, 
Stage 2 


V Allowance for Scrolling 


TESTING AND DEBUGGING THE PROGRAM 


NOTE: As you progress through this track, you 
will be making a number of modifications to the 
computer program. Each time you do so, be sure to 
save the modified program back to disk, so that you 
won't lose it if you have to stop and turn off the 
power. The original program is named LOAN, and 
should be left intact for future use. Therefore, save 
the program under a new name such as LOAN. As 
a matter of general good practice, you should never 
overwrite a program on disk until you are sure that 
you will not need to refer back to it for some reason. 

Accordingly, issue the command SAVE ”LOANI1”,8 
<return> each time you modify and test your LOAN 
program, and use different program names. 

Once you have actually coded the program and 
entered it into the computer, it is time to test it. No 
programmer expects the program to operate 
perfectly the first time. Many different kinds of errors 
can creep into a program, and they must be located, 
identified, and corrected before the program will 
produce the exact results desired. 
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The first round of errors is generally caused by ac- 
cidental misspellings of command key words, miss- 
ing parentheses, etc. This type of error produces a 
“Syntax Error” message or the equivalent, along 
with the line number in which the error was 
detected. The only way to find and eliminate this 
kind of error is to run the pfogram, wait until it 
announces such an error, and then LIST the offend- 
ing program line. Then you can locate and correct 
the error and run the program again. 

This phase of error correction can take a while, 
but is generally completed rather quickly. For 
demonstration purposes, we have already elimi- 
nated this kind of error, and your LOAN program 
will run the first time. However, as you will find out 
shortly, the program still does not run perfectly. 

For the fullest possible understanding of this track 
in your Learning Guide, you should have your com- 
puter available and operating at this time. If you can- 
not use your computer at this time, we suggest that 
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you repeat this track when you have a computer 
available to you. 
Now type RUN<return>, and observe the display. 


Sector 1: The Test Run 


As we had intended, the program first requests the 
amount of the loan. For test purposes, we should 
keep the numbers easy to work with, so that we can 


tell whether or not the results make sense. 
Therefore, type in 1000 <return>, to give us a loan of 


$1000. Similarly, let’s pick an interest rate that will give us 
a monthly rate of 1%. This means an annual rate of 12%. 
So, for interest rate, type in 12 <return>. Finally, use a 
12-month period for payback, so we won't have to look 
through numerous displayed lines. Type in 12 <return> 
for the duration of the loan. 

Now look over the display in Figure 7-1. The columns 
are not perfectly lined up due to the different lengths of 
different numbers, but we can follow them for now. How- 
ever, there does seem to be a major problem. The bal- 
ance seems to be increasing rather than decreasing the 
way it should. The amount of money going to principal is 
negative rather than positive. Even the calculated pay- 
ment is negative! Obviously something is wrong, but 
what? 


Sector 2: Identifying and Correcting the Problem 


To localize the problem, first go back to the top of the 
display, and determine which displayed result was 
the first to be in error. Now you can see why we used 
easy numbers for the test—it’s easier to figure out 
which result is incorrect. 


Track 7 


We see that the display title is correct, and so is the 
line recapping the original input parameters. 
However, the calculated payment is obviously 
wrong, since it is negative. Furthermore, the regular 
payment should be somewhere around $90, in order 
to pay both principal and interest in 12 payments. 
(Principal alone would be $1000/12 or $83.33, and 
we must add interest.) Clearly, more is wrong with 
this payment than just the sign. 

Let’s go back through the program listing, and find 
the line where the regular payment is calculated. Use 
LIST 100-199, LIST 200-299, etc. as we did before. 
You should find that the regular payment calculation 
occurs in line 210: 


210 PM = (MR * LO)/(1- (MR + 1) * NP) 


Now, let’s go back to the original formula: 


i -NY 
1 ( N + 1 ) 

We have already calculated i/N and called it MRate, 
the monthly interest rate. Similarly, NY has already been 
calculated as NP. The formula shows that the expression 
in the denominator has a negative exponent, but our line 
210 has a positive exponent (as indicated by the absence 
of a sign preceding NP). This has to be at least part of our 
problem. 

In BASIC, some method of editing (modifying) an exist- 
ing program line is provided. On the Commodore 64, 
this is done by using the cursor keys under the 
<return> key to move the cursor to the program line 
to be modified, and then inserting, deleting, or 
changing characters as _ necessary. When the 
<return> key is pressed, the changes are recorded in 
memory as with other compatible computers. 

Other versions of BASIC may use an EDIT com- 
mand or some other technique. If you are familar 
with the particular method used by your computer, 


Regular Payment = 
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REPAYMENT OF DECLINING INTEREST LOAN 


REFAYING $ 19000 AT 12 % INTEREST 
FOR 12 MONTHS. 


MONTHLY PAYMENT = #-78. 8487899 
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MONTH INTEREST PRINCIPLE BALANCE 

1 10 ~$8. 8497898 19088. 84879 

ro 10.8884879 at = hr Pe BATA = 1178.58607 
a 11. 7858607 -90. 6246506 1269 ..22072 
4 12. 6922072 —91.540997 1260. 76172 
a 13,.6076172 ~92. 456407 1457.21812 
& 14.5321812 9S. SBOP 11 1546.359909 
7 135. 4659909 -94,3147808 14640, 91387 
8 146. 4091287 =—95.. 2077285 1736.1718 
9 17,.561718 96. aor? 1832. 38231 


S238271 
19. 2955492 
20. 2769926 


ee 
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Fes] 
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_ 
th 
hj 


you can use it now to modify line 210 as specified 
below. If not, just type in a whole new line 210. The 
new line will replace the old line in any version of 
BASIC. We will look at edit procedures in more detail 
in a later module. The corrected line 210 looks like 
this: 


210 PM = (MR * LO)/(1 - (MR + 1)“(-NP)) 


Note that we have added a total of three characters to 
this line, all around NoPaymts. These three characters (a 
pair of parentheses and a — sign) change the sign of this 
exponent to match the sign in the formula. Check your 
modified program line to make sure it is correct, and then 
press the <return> key to place it in memory. 

Now RUN the program again, using the same values 
of 1000, 12, and 12 in response to the three questions. 

Figure 7-2 shows the results you should have obtained 
this time. The monthly payment of $88 plus change is 
reasonable, and very close to our estimate of $90. This 
further born out by the final balance of a small fraction of 
one cent, which we can call 0. (-1.50501728E-05 is a value 
expressed in exponential form which is equal to 
-0.0000150501728 in decimal notation.) 


Sector 3: Cleaning Up the Display, Stage 1 


We can now say that there are no actual errors left in 
the program. However, the results do not appear 
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~98, 1443391 


“99, 1257825 


1927. 53492 
2027. 69926 


2126. 82505 
Figure 7-1. Repayment of Declining Interest Loan 


reasonably as dollars and cents, and we certainly 
don’t need all those strings of decimal fractions. All 
payments will be in dollars and cents, and all results 
will be expressed in the same units. Let’s see if we can 
find a way to modify. the program to accomplish this. 

This is another situation where a_ working 
knowledge of the programming language (BASIC in 
this case) is called for. A familiarity with the com- 
mands and functions can save a lot of time looking 
through a keyword list and operations descriptions. In 
BASIC, we don’t have a command or function that 
will round a number off to the nearest penny. How- 
ever, we do have the INT function, which will trun- 
cate (cut off) the fractional part of a number, effec- 
tively replacing a number with the next lowest integer 
value. To see it in operation, type PRINT INT(3.6) 
<return>. The computer will respond with the number 3, 
indicating that this is the next lower integer value. We can 
use the INT function and a little arithmetic to round off 
our numbers to the nearest penny. 

The first step is to multiply a number by 100, so 
that we will have it in whole cents, rather than dollars 
and cents. Next, we want to add 0.5, to round off our 
number rather than drop a fractional part that might 
be nearly another cent. Then, we can take the INT 
function of the result to get a value in whole cents 
with no fraction. Finally, we convert back to dollars 
and cents by dividing by 100. 
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REPAYMENT OF DECLINING INTEREST LOAN 


REFAYING € 
FOF 


1900 AT 
12 MONTHS. 


Pace 


MONTHLY FAYMENT = 


MONTH INTEREST 


INTEREST 


€ 88.8487899 


FRINCIPLE 


BALANCE 


10 
F.2ltSlai 
B.4151S932 
7.61080282 
6. 79843295 
letter Feed 
Dalth Pol Coe 
4.351221478 
3. 46684903 
Pg op GS Oa 
bY fer weed 6 9 


»B7 9469084 
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78.8487899 
79. GS72778 
80. 423650& 
81.237937 
B82. 050367 
82.8798706 
is Cy Bald Fe 
84. 5265751 
85. 2819409 
86.2357603 
87. 0981179 
aie Kote dO he dee | 


921.15121 
841 ..513935 
761, 080282 
679. 842295 
DRis eee 
D14.921057 
421.221478 
346. 684903 
261. 2029623 
LAS 067202 
87. 9749084. 
-1.50501728E-05 


This sounds complicated when stating it in words. 
However, it is really quite straightforward. The 
BASIC expression would be: 


.... = (INT(N*100 + 0.5))/100 


where N is the number to be rounded off. N can be 
expressed as a variable name, a number, or any 
numeric expression. You can even put N on the left 
side of the = sign to round off a variable without 
changing its name. Let’s try this with the calculation 
of the monthly payment and see what happens. 

LIST lines 200-299. We have lots of space to 
make this addition. Let’s create a new line immedi- 
ately following line 210. Since we already have a line 
220, we'll call this new line 215, to put it between the 
existing lines. To do this, type in the line: 


Figure 7-2. Loan calculations with the corrected monthly payment. 


215 PM = (INT(PM* 100 + 0.5))/100 


Then, RUN the program again, using the same 
values, to see the result. 

Well, the payment calculation was correctly 
rounded off to $88.85. However, we will still have to do 
something about the calculation of interest foreach 
payment. When we LIST the program, we find that 
INterest is calculated in line 410. Now we must either 
modify line 410 or add a new line 415 to round off IN 
to the nearest cent. Also, we should replace the semi- 
colons in line 440 with commas. Go ahead and make 
these changes now, and then RUN the program once 
more. 

Now we’re getting close to what we want. The BAlance 
didn’t come out exactly right at the end, but all other 
values did. However, it would be a much neater display if 
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the decimal points lined up, and if we always had two 
digits for cents, even if the second digit is 0. Will BASIC 
allow us to do this? 

As it turns out, BASIC will. Commodore BASIC does 
not have any direct formatting capability as such, but we 
can nevertheless manipulate the format of the number to 
get the display we want. Since we will be doing this with 
many different numbers, we will set up a subroutine to do 
the work, and allow all of our dollar and cents numbers to 
have the same format. 

To make sure we will have plenty of room in our 
program, we will start our subroutine at line number 
1000. The number to be formatted we will call N. Thus, 
any time we want to format a number, we need only say N 
= (that number):GOSUB 1000. The subroutine can then 
print out that number in the proper format. 

We will also let the subroutine round off our numbers 
to the nearest cent. However, in so doing we will still 
round off numbers in our calculations so that BASIC 
won't accumulate any errors in the course of those calcu- 
lations. We will start with a REMark to identify the sub- 
routine, and then round off the number: 


1000 REM SUBROUTINE TO 
FORMAT NUMBERS 
1010 N = INT((N*100)+0.5)/100 


We cannot control the length of a numeric value. We 
can convert it to a character string, however, and then 
adjust the length and content of that string. We will start 
with the function STR$, which will create a character 
string from a number, exactly as if it were printed to the 
screen. Then, we will use string search techniques to find 
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the decimal point, remove any extra digits and add zeros 
if necessary, and then pad the number with leading spa- 
ces to set its length exactly. The conversion looks like 
this: 


1020 N$ = STRS(N) 
1030 N$ = “ ”+N$ 


Line 1030 adds 10 leading spaces to the string, so 
we will always have enough characters to fill out the 
desired column width. 


1040 IF MID$(N$,LEN(N$)-2,1)=”.” THEN 1080 
1050 IF MID$(N$,LEN(N$)-1,1)=”.” THEN 1070 
1060 N$ = N$+”.0” 
1070 N$ = N$+”0” 


These lines make sure that there are always two digits 
trailing the decimal point, no matter what was originally 
supplied. The LEN function returns the length, or 
number of characters in a string. 


1080 N$ = RIGHT$(N$, 10) 


This line makes sure that regardless of the number of 
digits in the number, it will always occupy 10 places on the 
screen. Therefore, all numbers will be right-justified and 
the decimal points will be aligned. 


1090 PRINT N$;:RETURN 


This line actually prints out the number and ends the 
subroutine. 
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To use this subroutine, replace lines 440 and 450 with 
the sequence: 


440 PRINT MO, 

450 N= IN:GOSUB 1000 
460 N= PR:GOSUB 1000 
470 N= BA:GOSUB 1000 
480 NEXT MO 

490 END 


Be sure to include the comma at the end of line 440. 
Try making these modifications to the program, and then 
see how the output looks. Can you find a way to make the 
MONTH column narrower (no more than 5 characters 
wide)? 

HINT: If you are not sure “What will happen if I 
do.....”, try it and find out. You cannot hurt the com- 
puter; the worst thing that can possibly happen is that 
you will get an error message. If that happens, modify 
the offending line and try again. 

HINT: Split line 440 into two separate program lines. 
Use a 3-digit integer format for the month, andacommon 
6-digit format for the other values. Be sure to include the 
decimal point. Also, remember the use of commas in the 
PRINT statements. 

Practice with the computer for a while. Then come 
back and compare your results with ours. 


Sector 4: Cleaning Up the Video Display, Stage 2 


There are several different ways to write any program 
or to accomplish any given task. If your modification 
to the LOAN program works properly, then it is a 
valid version, even if it is somewhat different from 
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ours. Figure 7-3 shows our modification to the LOAN 
program, and Figure 7-4 shows the resulting display. 
We left out the dollar signs, since that is assumed in a 
display of this type and extra symbols tend to clutter 
up the display. However, including dollar signs is not 
wrong, and if your modified program lines included 
them, that is fine. 

At this point, our LOAN program has a clean 
display, with decimal points aligned properly in each 
column. However, we still have a problem: the final 
balance should be zero. The difference we see here is 
due to the fact that we rounded off our payment, so 
that we could express it in terms of exact dollars and 
cents. In this case, this means that the final payment 
was one cent too large, leaving us with a negative 
balance. Of course, one cent we could ignore, but if 
we can get an error of one cent, we can get a larger 
error in other circumstances. Therefore, we need to 
eliminate this source of error. 

The answer is to use anew BASIC command, the 
IF statement. This statement allows BASIC to make a 
test, and to take different actions according to the 
result of that test. The format of the IF statement is: 


IF test THEN action to take if test result is true 


The test is basically a comparison of two expres- 
sions, using either one or two of the relational 
operators < , =, and >. These operators mean less 
than, equal, and greater than, respectively, and are 
used to define the relationship between the two ex- 
pressions we are looking for. The action to be taken 
may either be a BASIC statement or a line number. If 
it is a line number, BASIC will continue execution at 
that numbered line if the test was true. 

To solve our problem with the LOAN program, we 
need to test to see if the PRincipal payment exceeds the 
remaining BAlance. If it does, we want to reduce PRincipal 


MODULE 1 


Introduction to Programming and Software Design Track 7 


400 FOR MO = 1 TO NF 

419 IN = INT¢ (BAXMR*100)+0.5) /100 
420 PR = INT (0 (PM—-IN) *100)40,5) 7/100 
420 BA = INT (( (BA-FPR) *100)+0,5) 7/100 
440 PRINT RIGHT#(" “+STRS(MO)+" ",5): 
450 N=INsGOSUE 1000 

440 N=FPR:GOSUE 1000 

470 N=BA:GOSUB 1000 

480 FRINT 

490 NEXT MO 

500 END 


Figure 7-3. A working formatting method for the LOAN program. 


REPAYMENT OF DECLINING INTEREST LOAN 


REPAYING € 1000 AT 12 % INTEREST 
FOR 12 MONTHS. 


MONTHLY FAYMENT = # 88.85 


MONTH INTEREST FRINCIPLE BALANCE 
1 10.00 7S. oo SF Bex Lid 
= Peso 79.64 841.51 
= 8.42 BO.,42 761.098 
4 7.61 81.24 &79, 84, 
ral 6.80 82.05 Sint et 
& wa 7B 82.87 514.92 
F ovis 83.70 421.22 
8 4,51 4, 54 346.648 
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19 2eGl 86.24 173206 
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— Figure 7-4. Loan calculations with formatted output. 
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REPAYMENT OF DECLINING INTEREST LOAN 


REPAYING $ 1000 AT 12 % INTEREST 
FOR 12 MONTHS. 


MONTHLY FAYMENT = @ 88.85 


MONTH INTEREST FRINCIFLE BALANCE 
1 10,00 78.935 Sol. iS 
a P.21 79.64 841.51 
3 8.42 80.435 761.98 
4 7.61 81.24 679,84 
o 6.80 82.05 i ee oe 
& airy 82.87 314.92 
7 cae ir Sau.70 421.22 
8 4.1 84.54 246.68 
ee Sa 47 Baso8 Lod wae 

10 2.61 86.24 175.06 
i Lato B74 1.0 37 036 
12 »88 87.96 0.00 


Figure 7-5. The display after adding the final payment calculation. 


and Payment so that the BAlance will be exactly zero. We between BA and THEN in line 425. Either technique is 


can do this by inserting a new line 425 as follows: satisfactory, and both methods will achieve the same end 
result. Now the final balance will always be exactly zero. 
425 IF PR > BA THEN PR= BA However, the final payment may be (and probably 


will be) different from the regular payment, because 
of this same rounding off. Let’s include a line at the 
Figure 7-5 shows the display that results when this end of the program to tell us exactly what the final 
line is added. payment is, including both interest and principal. We 


We noted above that our final balance was -0.01 can do this readily by adding a new line at the end of 
because the payment was rounded up to the nearest the program, such as: 


whole cent. But what if the payment is rounded down? 


Then, we will have a small positive balance. Line 425 495 PRINT:PRINT “Final Payment = $”;IN + PR 
won't help us here, because BAlance will still be greater 

than PRincipal. We need another IF statement, to make Now, RUN the program again, and examine the 
sure that the entire remaining balance is included in the results. Figure 7-6 shows the results you should see 
final payment, even if this increases the final payment. on your screen. 


We can either add a new line such as the following: 


427 IF MO = NP THEN PR = BA 


or else put the test: 


Sector 5: Allowance for Scrolling 


One of the biggest problems with a video display is 
OR MO = NP the limited amount of information that can be 
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displayed on it at one time. To see what we mean, 
RUN this program again. However, this time use a 
loan amount of $4000, an interest rate of 10%, and 
a payback period of 36 months. This corresponds to 


Track 7 


upward. The top line was lost, and the new bottom 
line was blank, leaving room for the computer to 
write more information. The problem is that we didn’t 
have time to read the display before it disappeared off 
the top of the screen. How can we prevent this from 
happening? 

As usual, there are several approaches we might use. 
We could insert a delay between lines, or require that all 
calculations be for one-year loans, but these seem 


unreasonable. It would be better if we could list 12 lines at 
a time, then wait for the user to press a key. Then, the 
program could print out the next 12 lines, on top of the 
first 12 lines. This would leave the headers on the screen 
as titles, and improve the readability and utility of the 


a three-year loan, possibly for part of the purchase 
price of a new car. What happened to the display? 
What happened was that as the computer wrote to 
the last line on the display, the video handling 
y program proceeded to scroll all display lines 


REF AYMENT OF DECLINING INTEREST LOAN 


REFAYING # 1900 AT 12 % INTEREST 
FOR 12 MONTHS. 


MONTHLY FAYMENT = # 88.85 


MONTH INTEREST FRINCIFLE BALANCE 
1 10,090 Aarne, Few LS 
2 Deed 79.64 841.51 
= 8.42 80,42 761008 
4 FArcek! 81.24 679.934 
b= 6.80 ve aey Oral Dae ais 7 
& ae 78 82,87 314.92 
ee a. 15 B82. 70 431.22 
8 4.31 84,54 246.48 
id au A? Bhiscnh 261.50 

10 a BS. 24 Pde 06 
et peat See, LO 87.96 
vz .88 87.76 0.00 


FINAL FAYMENT = # 88.84 


— 


Figure 7-6. Adding the final payment statement. 
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display. At the same time, we had better blank out the 
previous 12 lines, in case the loan lasts for a number of 
months that do not add up to an exact number of years. 
Now, let’s see what that will require: 


e We will have to move the cursor to the start of each 
group of 12 lines, but not for each line. We may be able 
to include this at the end, since the first group of lines 
won't need it. 

¢ We will need an IF statement at the end of the loop 
to find out if we have displayed an integer multiple 
of 12 lines. 

e We will need an inner loop to erase the present 
lines. 

¢ We will need some kind of INPUT statement or 
equivalent to wait for a key to be pressed. 

e We should display a “Press any key to continue...” 
message at the bottom of the screen, while waiting for a 
key. 


Looking at the current program listing, we 
already have a line 480 as well as a line 490, and our added 


IF INT(MO/12)<>MO0/12 OR MO=NF THEN 570 
PRESS ANY KEY TO CONTINUE... "3 


DILCDALECDILEDIAMs 


ECRILEDALCD ITER Is 


$"s IN+PR 


Figure 7-7. The added lines for a one-year-at-a-time display. 


lines will have to go in between these two. However, we 
then have an open space. Therefore, it is not difficult to 
just write the required new program lines, and then 
retype the two final program lines with appropriate new 
line numbers. 

As usual, there are many ways to accomplish this 
task. Figure 7-7 shows one possibility, which also 
checks for the last payment, and bypasses the wait 
routine in that case. This leaves the last year or partial 
year on the screen along with the final payment. 

Add the lines of Figure 7-7 to your LOAN pro- 
gram. Then, RUN the program again. Use $4000, 
10% interest, and 36 months as before. Is this now a 
more useful display? 

Now that the program works properly for a range of 
inputs, stop and SAVE “LOAN1”,8 <return>. There are 
several more improvements we could make to this pro- 
gram, but this will serve to demonstrate the procedures 
involved in debugging programs. Do not lose the modi- 
fied program, however, because you will need it later on. 
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DOCUMENTATION 


PROGRAMMER’S 
MANUAL 


-USER’S MANUAL 


COMMENTS 


Now that we have a working program (not perfect, 
but at least it does work), it is time to document it. 
Documentation basically consists of three parts: com- 
ments in the program itself, a user’s manual, and a 
programmer’s manual. 

The programmer’s manual is a detailed description 
of the program and its operation. This is the manual 
that would be used as a reference by any program- 
mer seeking to modify or upgrade the program. The 
types of descriptions and explanations given in Track 
7 would go into the programmer’s manual. 

The user’s manual would be the general operating 
manual for the program. This manual would contain 
a description of the operation of the program, 
together with one or more sample sessions. The user 
would refer to this manual in case of any question or 
doubt concerning the behavior, capabilities, and 
limitations of program operation. The material in 
Track 7 does not constitute a complete user’s 
manual. 
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We will not write either manual at this point. The 
LOAN program is not yet finished, and until it is, both 
manuals would have to be updated to follow the 
changes in the program. However, it is a good idea at 
this point to go back to the program and insert com- 
ments to define the various program segments. Then 
these comments can serve as a guide and memory 
refresher when you go back to make additional 
modifications to the program. 

Figure 8-1 shows the program listing in its present 
form. The comment in line 40 is no longer correct. 
You, the student, have already corrected the error 
and extended the program. Therefore, you should 
rewrite line 40 to indicate this. A line such as: 


35 REM Modified program, corrected and extended in 
Module 1 


would be appropriate at this point. 


In addition, this is the time to add some comment 
lines describing the purpose of each section of the 
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10 REM CONTEMFORARY SOFTWARE DESIGN 
15 REM MODULE 1 rd 

20 REM : 
B= REM DECLINING INTEREST LOAN FROGRAM 
=O REM 

25 FEM INITIAL PROGRAM TO BE EXTENDED 

40 REM AND CORRECTED BY THE STUDENT 

45 REM 

BO REM MCGRAW-HILL 

= REM CONTINUING EDUCATION CENTER 

60 REM Z°Z9 WISCONSIN AVENUE, NW 

&S5 REM WASHINGTON, DC 20014 

70 REM ; 

a0 REM 

90 REM 

100 PRINT" CCSICCRICCRIREPAYMENT OF DECLINING INTEREST LOAN" 

110 INPUT" CCDIAMOUNT OF LOAN":LoO 

120 INFUT"INTEREST RATE (EG, 11.5) ":IR 

120 INFUT"DURATION OF LOAN IN MONTHS": NF 

200 MR=IR/ 1200 


210 Mes (MR*#LO) / (l= (MR+1)~ (=NP) 
215 PM = INT CCPM*100)4+0.5) 7100 
220 BA = LO 


ZOO PRINT" COSICCRICCRICCRIREPAYMENT OF DECLINING INTEREST LOAN" 

Z1O PRINT:P RINT REPAYING $"sLO:"AT"sIR:"% INTEREST" 

200 PRINT FOR :NPs "MONTHS, " 

) PRINT:PRINT'MONTHLY PAYMENT = #°;PM 

B40 PRINT: FRINT"MONTH", "INTEREST", "PRINCIPLE", "BALANCE" 

E50 PRINT" CISSIC1L9SICISSICISSICISSICISSILCASSICISOSICIOSICISSICAPSICIPSICISOSIC19SI 

LISS ICASSILCISSICISSILCAISSILLSSICISSICLSSICISSILCISSILISSILIOSICIOSICISSICISOSICLSS 
PIGSICISSICLSSILCLSSICISSICISSICISSICISSICASSIC1OSI": 

400 FOR MO = 1 TO NF 

410 TN = INTC (BAXMRX100)+40.5) 4100 Lv 
420 PR = INT((CPM-IM) *100)+0.5) 7100 

425 IF PROBA THEN FR = BA 

427 IF MO=NF THEN PR = BA 

420 BA = INT (¢(BA-PR) *100)+0.5) 7100 

440 PRINT RIGHT#(" "S4ETRS(MO)4+" ".5): 

450 N=IN:GOQSUE 1000 

460 N=FR:GOSUER 1000 

470 N=BA:GOSUB 1000 

480 FRINT 

490 IF INT(MO/12)<=M0/12 OR MO=NFP THEN 570 

BOO PRINTSPRINT" PRESS ANY KEY TO CONTINUE..." 

510 GET At:IF AS="" THEN 510 

S20 PRINT" CHCICCDILCDICCDICCDICCDICCDILCCDILCCDICCDI"s 

S20 FOR I=1 To 14 

S40 PRINT" " 

S50 NEXT I 

560 PRINT’ CHCILCDICEDILCDILCCDICCDILCCDILCCDICCDILCSDI"; 

570 NEXT MO 

580 PRINT: PRINT'FINAL PAYMENT = #": IN+FER 

400 END 

1000 REM SUBROUTINE TO FORMAT NUMBERS 

1010 N = INTC(NK100)+40.5) 7/100 

1020 N@ = STRE CN) 
1020 Nt = " NaN 

1040 IF MID#(NS,LEN(N$)-2,1)="." THEN 1080 
1950 IF MID¢#(N¢,LEN(N$)—1,1)="." THEN 1070 
1060 N¢ = NS+e".0" 

1070 N& = Nee"o" 

1080 N& = RIGHTS (NS, 10) 

1090 PRINT N@::RETURN 


HOW 


Hou 


Figure 8-1. The LOAN program in its latest form. er | 
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program. For example, you might type in lines as 
follows: 


97 REM 
98 REM Input the initial data. 
99 REM 


to identify the block of program lines in the 100’s. As 
an alternative, you might put the comment from line 
98 at the end of line 100, and add several spaces to 
move the comment toward the right edge of the 
screen where it will stand out. If you do this, you will 
not need the extra blank comment lines, which we 
included just to make space in the listing. 
Additional comment lines might be: 


197 REM 

198 REM Perform preliminary calculations and initialize 
variables. 

199 REM 


297 REM 
298 REM Clear the screen and display the header. 
299 REM 


397 REM 
398 REM The main program loop. 
399 REM 


487 REM 
488 REM Display 12 months at a time. 
489 REM 


These comments have no effect whatsoever on the 
operation of the program. They do not show up in 
the program output, nor do they affect the results of 
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the calculations. They appear only in the program 
listing. The comments are then used by programmers 
who may wish to check the operation of the program, 
or possibly extend it or update it for greater operating 
possibilities. 

Comments may seem unnecessary at this point. 
After all, the LOAN program is quite short, and we 
have described its operation in detail in this module. 
However, not all programs are this short. In fact, 
most commercial programs are many times longer 
than this one. In addition, you may use this program 
for several weeks, months, or even years before you 
decide to modify it further. When you scan through 
the listing, these comments serve as guides through 
the program, to help explain what each program 
segment is supposed to do. 

As you work on any program, comments of this 
kind not only help you to determine just what each 
program segment does, but they also help you to 
locate specific program segments when you need to 
refer to them. Accordingly, it is very worthwhile to 
include comments in any program as you code and 
modify it. 
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LOOKING AHEAD 


In this module, we have taken a brief look at the 
general process of computer programming. We have 
described the basic steps in the programming process, 
and we have taken a closer look at most of these 
steps. However, we have not covered the entire pro- 
gramming process. In future modules, we will 
examine each of the programming steps in detail. 


Sector 1: Coming Up 


There is an old saying: “Well begun is half done.” 
This saying applies to programming as much as to 
other disciplines, and possibly more. It is certainly 
true that if you pay proper attention to details early in 
the programming process, the remainder of the pro- 
cedure is much easier. On the other hand, a mini- 
mum effort start will usually compel you to go back 
and repeat work that should have already been com- 
pleted but wasn’t. Above all, you should have your 
efforts organized, so that you can easily refer back to 
work you have previously completed on a problem. 
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In your next module, we will explore organized 
ways to attack a problem for which a computer solu- 
tion is desired. This includes the first two programming 
steps described in this module: defining the problem 
and its solution. We will see how to get started with the 
development of any brand new program. 


Sector 2: A Problem for Practice 


While an understanding of the theory of program- 
ming is essential for the efficient design of programs, 
practice in the various phases of programming is also 
important. It is through practice that you convert a 
theoretical knowledge of the subject into a real under- 
standing of the actual procedures and requirements. 

The LOAN program that we developed in this 
module still contains a number of shortcomings, 
which can be corrected by making a number of exten- 
sions and minor modifications to the program as it 
now exists. The biggest problem is that, as written, 


i 
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the program is not sufficiently flexible to handle all of the 
types of situations that might normally be required of it. 
For example, no method has been provided for sending 
the output to the printer rather than to the screen. In 
addition, it is sometimes desirable to tell the program 
what the monthly payment is, rather than having the 
program calculate it. 

Another problem is the display format. We did reduce 
the number of display columns used to handle the month, 
but we still have a somewhat limited column width due to 
the video display characteristics. Even one more display 
column for each money value would be nice. 

If you are listing an existing home mortgage, you might 
want to state the known principle + interest payment, and 
deliberately overstate the number of payments left to be 
made, since you don’t know this figure exactly. In sucha 
case, the program should stop itself when the principal 
balance falls to zero, even if more payments were 
indicated. 

In many cases, it is useful to include the accumulating 
principal and interest that have been paid as of each 
payment on a loan. This is often helpful when you com- 
pare monthly payments versus payoff term for different 
loans. You might be amazed at how much interest you 
pay on a long-term loan. 


Sector 3: A Practice Project 
For practice in modifying and updating programs on your 


own, try adding the factors described in Sector 2 above to 
your LOAN program. The video display should have the 
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column headings better centered over the number 
columns, and the column widths should be increased to 
12 characters each, including blanks. The MONTH 
column need only have room for three digits of display, 
since 1000 months is equal to over 83 years. Be sure to 
leave a blank column at the right edge of the display. 
To send output to the printer, first issue the command: 


OPEN 4,4 


Then you can send output to the printer with the com- 
mand PRINT#4, rather than just PRINT. The printed 
output should include columns for Interest-to-Date and 
Principal-to-Date. You should also report total interest 
paid at the end of the program, both on the printer and on 
the video display. 

Use of the printer should be optional for each run of the 
program. Your program should ask if this is desired. If 
your program does call for the printer, remember to 
CLOSE 4 when the printer is no longer required. 

As you work with your program, test it periodically 
to make sure that each change produces the desired 
results. Remember to save successful modifications 
back to disk, so they won’t be lost. When you have 
completed your changes to the program, you will 
have a full-function declining-interest loan program, 
which will be available for your use at any time in 
the future. 

If you have trouble incorporating any of these 
capabilities into your program, don’t worry. We do 
suggest that you give it your best shot, since the 
experience will prove valuable as you progress 
through this series. However, the disk for Module 2 
will contain the LOAN program with all of these 
changes incorporated into it, for comparison 
purposes. 

In the meantime, if you are not entirely sure of 
what a particular instruction sequence will do, try it 
and find out! You cannot hurt the computer this way, 
and trying the sequence will tell you more about its 
operation than just thinking about it. 
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